#

| Chapter 52 What's on the Disc |

## 52.7 Other Ways to Get the Software

If you are unable to read the CD-ROM, here are two other sources for all or some of the software on it.

### 52.7.1 Alternative Media

Ready-to-Run Software can provide the Power Tools software on alternative media such as floppies, QIC, 8 mm, 4mm, or DEC TK50 tape cartridges. Obviously, some of these media are appropriate only for certain platforms.

Because of the large volume of data on the CD, each tape/floppy package is for a single platform. In addition, for the floppy distributions, source and binaries are treated as separate packages, as are the bitmaps for use with pbmplus (43.25).

For ordering instructions, please see the very last page of this book, immediately facing the envelope that contains the CD-ROM disc.

### 52.7.2 Online Archive

Scripts and other example files from the book are in a freely available archive on the Internet at ftp.oreilly.com. (The archive is also available on ftp.uu.net. Other computers around the Internet have copies of UUNET's archives. If you aren't in the USA, ask your network administrator whether there's a UUNET "mirror" archive in your part of the world.)

The archive doesn't have everything from the CD-ROM. We didn't include the source code for programs that must be compiled (52.8) because you can get periodically updated copies from online archives around the Internet. The executable binary files for those programs aren't in our online archive, either. Ready-to-Run Software invested a lot of time and money to build and debug them. Get those binaries from this book's CD-ROM or alternate media.

There's also a web page for this book's software on http://www.oreilly.com; look for the UNIX Power Tools page. You'll find the complete archive file, links to each script in the archive, as well as links to much of the source code. Note that the source code is unmodified, original source - not including any porting fixes that Ready-to-Run added, and not necessarily the same version that's on the CD-ROM. We hope the page is useful for you.

The online archive file is a tar archive that has been compressed with the gzip command. After you get the archive, read article 19.7 to find out how to extract the files. You can also get individual scripts and files (but not source code) from the FTP archive's subdirectory named split.

#### 52.7.2.1 FTP

To use FTP, you need a machine with access to the Internet. The whole archive is at ftp://ftp.oreilly.com/published/oreilly/power_tools/unix//upt9707.tgz. Individual files are at ftp://ftp.oreilly.com/published/oreilly/power_tools/unix//split/. You can also use a web browser. Otherwise, use your UNIX ftp program; here's a sample session, with what you should type in `boldface`:

>     % ftp ftp.oreilly.com
>     Connected to ftp.oreilly.com.
>     220 FTP server (Version 6.21 Tue Mar 11 22:09:55 EST 1997) ready.
>     Name (ftp.oreilly.com:yourname): anonymous
>     331 Guest login ok, send domain style email address as password.
>     Password: yourname@domain.com (use your user name and host here)
>     230 Guest login ok, access restrictions apply.
>     ftp> cd /published/oreilly/power_tools/unix/
>     250 CWD command successful.
>     ftp> binary Very important! You must specify binary transfer for compressed files.)
>     200 Type set to I.
>     ftp> get upt9707.tgz
>     200 PORT command successful.
>     150 Opening BINARY mode data connection for upt9707.tgz.
>     226 Transfer complete.
>     ftp> quit
>     221 Goodbye.
>     %

#### 52.7.2.2 FTPMAIL

FTPMAIL is a mail server available to anyone who can send and receive electronic mail to and from Internet sites. This includes any company or service provider that allows email connections to the Internet. You do not need to be directly on the Internet. Here's how to do it.

You send mail to ftpmail@online.oreilly.com. In the message body, give the FTP commands you want to run. The server will run anonymous FTP for you and mail the files back to you. To get a complete help file, send a message with no subject and the single word "help" in the body. The following is a sample mail session that should get you the examples. This command sends you a listing of the files in the selected directory, and the requested examples file. The listing is useful in case there's a later version of the examples you're interested in.

>     % mail ftpmail@online.oreilly.com
>     Subject:
>     reply yourname@domain.com  (where you want files mailed)
>     open
>     chdir /published/oreilly/power_tools/unix/
>     dir
>     binary
>     mime (or uuencode if you don't have MIME)
>     get upt9707.tgz
>     quit
>     .         (The dot is a command to send the message, not part of it)

A signature at the end of the message is acceptable as long as it appears after "quit."

All retrieved files will be split into 60KB chunks and mailed to you. If your email program handles MIME messages properly, it should let you combine the partial messages and extract the archive file. Or, if you asked for uuencoded messages, remove the mail headers, concatenate the messages into one file, and run uudecode (19.5) on it. Once you've decoded the file, read article 19.7 about extracting the files from the archive.

To get individual files from the split subdirectory, use the command `chdir /published/oreilly/power_tools/unix//split`. Instead of `binary`, use `ascii`. You may also be able to omit the `mime` (or `uuencode`) to get these individual files without encoding.

#### 52.7.2.3 UUCP

The examples are available by UUCP via modem from UUNET. If you or your company has an account with UUNET, you will have a system with a direct UUCP connection to UUNET. Find that system, and type the following command on one line (it's broken onto two lines here for publishing):

>     uucp uunet\!~/published/oreilly/power_tools/unix//upt9707.tgz
>         yourhost\!~/yourname/

The backslashes can be omitted if you use the Bourne shell (sh) instead of csh. The file should appear some time later (up to a day or more) in the directory /usr/spool/uucppublic/yourname. If you don't have an account but would like one so that you can get electronic mail, contact UUNET at 703-204-8000.

- TOR, JP

52.6 Don't Have a CD-ROM Drive? |  | 52.8 Building Programs from Source Code